home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_7 / issue_05 / update / readme < prev    next >
Encoding:
Text File  |  1994-01-10  |  5.5 KB  |  123 lines
  1. ARCHIVE Magazine Index Data for ARCSCAN III Filing System
  2. =========================================================
  3. [C] E.W.Ayers : Jan 1994            update to 10.01.94
  4.  
  5. ARCSCAN is a trademark of RISC Developments Ltd.
  6.  
  7.  
  8. 1. Organisation of ARCSCAN III
  9.  
  10. ARCSCAN III provides for two types of files:
  11.  
  12. Type 0     Magazine Files  -  With regular Volume and Issue numbers
  13. Type 1     Others
  14.  
  15. The files are held within Directories, and a !Custom file tells ARCSCAN
  16. what files to offer in its menu display, where to find them, and how to
  17. display  the  information  contained  in them. To add new sets of data to
  18. ARCSCAN, the appropriate directories must be created to contain the data,
  19. and the !Custom file must be extended to specify them.
  20.  
  21. Once this has been done, files may be updated/extended, or further files
  22. may be added to any existing DIRECTORIES. Provided they conform to the
  23. format prescribed in the !Custom file, no further changes to the
  24. latter will be needed.
  25.  
  26.  
  27. 2. Data on this Disc
  28.  
  29. The ARCHIVE data on this disc includes three sets of files:
  30.  
  31.    ARCHIVE Magazine contents    -  Type 0
  32.                                 -  Directory 'Archive'
  33.                                 -  Files     ARvol06  (Vol6, 1-12)
  34.                                              ARvol07  (Vol7, 1-4)
  35.    ARCHIVE Monthly Discs        -  Type 0
  36.                                 -  Directory 'ArDiscs'
  37.                                 -  Files     Advol06  (Vol6, 1-12)
  38.                                              Advol07  (Vol7, 1-4)
  39.    ARCHIVE Care/Shareware Discs -  Type 1
  40.                                 -  Directory 'ShareCare'
  41.                                 -  Files     Careware   (Nos 1-21)
  42.                                              Shareware  (Nos 0-51)
  43.  
  44. If you already have one or more of these directories, then the appropriate
  45. files can be simply copied into them (any earlier version of the SAME file
  46. will be overwritten, but files for earlier volumes will be unaffected).
  47. If however a directory is not present you will have to extend the !Custom
  48. file (see below) and create the required directory first.                                            
  49.  
  50. 3. The !Custom File
  51.  
  52.   3.1 The Length parameter
  53.  
  54. The !Custom file provides for specifying the maximum length of each entry
  55. in a file, and this is used to organise the 'paging' of the ARCSCAN
  56. display. For the Type 0 files above, the length is set to 6, so that
  57. several entries appear on each 'page' of the display. For the Type 1 file
  58. above, the length is set to 25 (the maximum allowed), so that the display
  59. shows one disc at a time. Setting this parameter wrongly, or exceeding the
  60. specified length for an entry, may result in parts of a record scrolling
  61. off the ARCSCAN display or being overwritten before they can be read.
  62.  
  63.  
  64.   3.2 Modifying the !Custom file
  65.  
  66.          **** BACKUP your ARCSCAN Disc before proceeding! ****
  67.  
  68. To modify your !Custom file, get !Edit installed on the DeskTop Icon Bar.
  69. Insert your ARCSCAN disc, and open a filer window. HOLDING DOWN SHIFT,
  70. double-click on !ArcScan to open a sub-window, which should contain the
  71. !Custom file. Drag this to !Edit. The latter should open a window
  72. displaying the file contents. Click MEN (centre button) on this window,
  73. and select Edit -> CR-LF, which should make the file readable.
  74.  
  75. Go to the foot of the list, using the scroll bars, and examine the last
  76. block of entries - it will start with '#' plus a number. NOTE THIS NUMBER
  77. - your entry will be the next number. At the end of the file you should
  78. find '##'. Position the cursor (SELect on the mouse pointer) to the
  79. immediate LEFT of this entry, and press RETURN. This should insert a blank
  80. line before the '##' file terminator. Move the cursor up to the start of
  81. it.
  82.  
  83. You now have to key in the entries for your new data. The formats are
  84. shown below for each of the three data sets. You may choose to enter just
  85. one, two or all three, but each entry must be matched by later creating
  86. the appropriate directory, else ARCSCAN is liable to have a nervous
  87. breakdown!
  88.  
  89.  
  90.   3.3 New Entries in !Custom file
  91.  
  92. The tables below show the entries for each of the three data sets. The
  93. parameter shown as <n> is to be replaced by the next entry number (without
  94. the '< >' ). The tabulated entries should be inserted between the last
  95. existing entry and the end-of-file marker '##', with no blank lines,
  96. extra spaces or other characters. NB no RETURN after the last item in the
  97. list!
  98.  
  99.                      
  100. ARCHIVE Magazine             Monthly Discs            Share/Careware Discs
  101. ----------------             -------------            --------------------
  102.  
  103. #<n>                         #<n>                     #<n>
  104. Archive                      ArDiscs                  ShareCare
  105. Archive                      ArDiscs                  ShareCare
  106. Archive                      ArDiscs                  Sharecare
  107. ARvol                        Advol                    *
  108. 0                            0                        1
  109. 6                            6                        25
  110.  
  111.   
  112.   3.4 Saving the Amended !Custom File
  113.  
  114. Now again select Edit -> CR-LF by the MEN button, to compact the data.
  115. Click MEN on your !ArcScan sub-window, select 'File !Custom -> ' and then
  116. the delete option to remove the old file. Click MEN on the !Edit window
  117. and select SAVE which will open a save box and an Icon. Check that the box
  118. still shows the filename as ....!Custom, and drag the Icon to your
  119. !ArcScan sub-window. Create new directories with the names you have
  120. specified and copy the data files into them as indicated in para. 2 above.
  121.  
  122.                          ----- o -----
  123.